popover: Document signals
authorMatthias Clasen <mclasen@redhat.com>
Tue, 17 Nov 2020 03:46:17 +0000 (22:46 -0500)
committerMatthias Clasen <mclasen@redhat.com>
Tue, 17 Nov 2020 12:34:52 +0000 (07:34 -0500)
gtk/gtkpopover.c

index 2a17b677dafa98fc5828790d1fc70d404da737e5..240b9bb58b15496b71c25c26324c235d7af0517b 100644 (file)
@@ -1679,6 +1679,12 @@ gtk_popover_class_init (GtkPopoverClass *klass)
 
   g_object_class_install_properties (object_class, NUM_PROPERTIES, properties);
 
+  /**
+   * GtkPopover::closed:
+   * @self: the #GtkPopover which received the signal
+   *
+   * The ::closed signal is emitted when the popover is closed.
+   */
   signals[CLOSED] =
     g_signal_new (I_("closed"),
                   G_TYPE_FROM_CLASS (object_class),
@@ -1689,6 +1695,15 @@ gtk_popover_class_init (GtkPopoverClass *klass)
                   G_TYPE_NONE,
                   0);
 
+  /**
+   * GtkPopover::activate-default:
+   * @self: the #GtkPopover which received the signal
+   *
+   * The ::activate-default signal is a
+   * [keybinding signal][GtkBindingSignal]
+   * which gets emitted when the user activates the default widget
+   * of @self.
+   */
   signals[ACTIVATE_DEFAULT] =
     g_signal_new (I_("activate-default"),
                   G_TYPE_FROM_CLASS (object_class),